Generar de orden de compra

Se realiza el proceso de generacion de órdenes de compras

Request 🚀

url

https://app.aveonline.co/api/nal/v2.0/ordendeCompra.php

Method

POST

Header

Nombres e identificadores comerciales ficticios; se conservan los códigos públicos. Sustitúyelos por los de tu cuenta autorizada. Estos ejemplos no identifican empresas de QA ni conceden acceso.

Content-Type: application/json

Params JSON

• tipo* String Enrutador de la API, "generarorden"
• token* String. Usa el valor de token de Autenticación. Consulta su vigencia en esa referencia.
• idempresa* Number Identificador del usuario dentro de AVEONLINE, se obtiene en la Autenticación
• idagente* Number Identificador del agente [agentes/listadoagentes]
• idproveedor* Number Identificador del proveedor [ordenesdecompra/listado de proveedores]
• ordencompra* String Número de orden de compra,
• idtransportador Number Código del transportador [nacional/listado de transportadores],
• modoenvio Number Forma de generar envio: 1=por tiempo, 2=por costo ,
• detalle* Array Object -> [{}]
  • pedido* String Número del pedido
  • fecha_min Date Fecha mínima despacho orden de compra (DD/MM/AAAA)
  • fecha_max Date Fecha máxima despacho orden de compra (DD/MM/AAAA)
  • plu* String Código interno de la orden de compra por cliente
  • ean* Number Código ean del producto
  • referencia* String Código referencia del producto
  • nombre_articulo* String Nombre del producto
  • descripcion String Descripción del producto
  • cantidad_solicitada* String Cantidad del producto
  • precio* Number Valor unitario del producto (sin puntos ni decimales)
  • total* Number Valor total del producto (sin puntos ni decimales)
  • valoracion* Number Valoración total del pedido(sin puntos ni decimales)
  • cliente* String Cliente destino
  • puntoventa String Punto de venta asociado
  • ciudad* String Ciudad destino (sin tildes ni ñ) [nacional/listado de ciudades]
  • departamento* String Departamento destino (sin tildes ni ñ) [nacional/listado de ciudades]
  • direccion* String Dirección destino
  • tel* String Teléfono destino
  • correo* String Correo electrónico destino
  • observaciones* String Observaciones pedido
  • peso* Number Peso en kilogramos del pedido (sin puntos ni decimales)
  • alto Number Dimensión alto en cms
  • largo Number Dimensión largo en cms
  • ancho Number Dimensión ancho alto en cms
  • cartaporte Number Código cartaporte (0 o 1)
  • campana String Nombre campaña asociada
  • guia String Número de envío predeterminado
  • factura String Número de factura asociada al pedido
  • fecha_redencion Date Fecha estimada de redención (DD/MM/AAAA)
  • codigo_dane* String código dane ciudades (8 posiciones) [nacional /listado de ciudades]

Ejemplo

Nombres e identificadores comerciales ficticios; se conservan los códigos públicos. Sustitúyelos por los de tu cuenta autorizada. Estos ejemplos no identifican empresas de QA ni conceden acceso.

{
  "tipo": "generarorden",
  "token": "<TOKEN_FICTICIO_NO_UTILIZABLE>",
  "idempresa": 0,
  "idagente": "<IDENTIFICADOR_FICTICIO>",
  "idproveedor": "",
  "ordencompra": "000000000000",
  "detalle": [
    {
      "pedido": "000000000000",
      "fecha_min": "2022/12/01",
      "fecha_max": "2022/12/12",
      "plu": "000000000000",
      "ean": "",
      "referencia": "000000000000",
      "nombre_articulo": "Nombre ficticio de ejemplo",
      "descripcion": "",
      "cantidad_solicitada": "1",
      "precio": "123653",
      "total": "123653",
      "valoracion": "115000",
      "cliente": "Nombre ficticio de ejemplo",
      "puntoventa": "",
      "ciudad": "La Jagua De Ibirico",
      "departamento": "Cesar",
      "direccion": "Dirección de ejemplo, sin ubicación real",
      "tel": "0000000000",
      "correo": "persona@example.test",
      "observaciones": "Texto ficticio de ejemplo",
      "peso": "8",
      "alto": "10",
      "largo": "20",
      "ancho": "30",
      "cartaporte": "",
      "campana": "",
      "guia": "",
      "factura": "",
      "fecha_redencion": "2022/12/15",
      "codigo_dane": "08001000"
    }
  ]
}

Response 📄

Success

• status String Estado del resultado
• message String Mensaje de respuesta
  • codigo Array Object -> [{}]
    • id String Posición de lectura de cada linea
    • text String Linea de respuesta de cada linea

Ejemplo

Nombres e identificadores comerciales ficticios; se conservan los códigos públicos. Sustitúyelos por los de tu cuenta autorizada. Estos ejemplos no identifican empresas de QA ni conceden acceso.

{
  "status": "ok",
  "message": "OC 0000 generada con exito",
    "codigo": [
      {
      "id": "<IDENTIFICADOR_FICTICIO>",
      "text": "Linea 1 pedido 0000 Generado"
      }
    ]
}

Error

Existencia de OC

Nombres e identificadores comerciales ficticios; se conservan los códigos públicos. Sustitúyelos por los de tu cuenta autorizada. Estos ejemplos no identifican empresas de QA ni conceden acceso.

{
  "status": "error",
  "message": "LA OC ya se encuentra asociada",
  "codigo": []
}

Faltan parametros

Nombres e identificadores comerciales ficticios; se conservan los códigos públicos. Sustitúyelos por los de tu cuenta autorizada. Estos ejemplos no identifican empresas de QA ni conceden acceso.

{
  "status": "error",
  "message": "Faltan parametros",
  "codigo": []
}

Credenciales incorrectas o token expirado

Nombres e identificadores comerciales ficticios; se conservan los códigos públicos. Sustitúyelos por los de tu cuenta autorizada. Estos ejemplos no identifican empresas de QA ni conceden acceso.

{
  "status": "error",
  "message": "credenciales incorrectas",
  "codigo": []
}

No se encuentran datos asociados

Nombres e identificadores comerciales ficticios; se conservan los códigos públicos. Sustitúyelos por los de tu cuenta autorizada. Estos ejemplos no identifican empresas de QA ni conceden acceso.

{
  "status": "error",
  "message": "se produjo un error al momento de iniciar la comunicacion",
  "codigo": []
}